Installing the Message Queueing Monitoring Agent
Unlock the full potential of your enterprise message queue monitoring with the Nodinite Message Queueing Monitoring Agent. This guide provides a step-by-step installation process, ensuring you can quickly deploy robust, secure, and scalable monitoring for Microsoft MSMQ, Apache ActiveMQ, and Microsoft Service Bus.
✅ Fast, guided installation for all supported platforms
✅ Centralized monitoring and management from the Nodinite Control Center
✅ Secure, role-based access and compliance with enterprise standards
✅ Comprehensive troubleshooting and support resources
This guide teaches how to install the Nodinite Message Queueing Monitoring Agent.
Important
You must be a local administrator to have the right to install Windows Services.
Before you begin
Make sure you comply with the prerequisites for the Message Queueing Monitoring agent.
Step 1: Start the installer
Double-click on the MSI file to start the installation of the Nodinite Message QueuesMonitoring Agent.
The installation begins with the MSI package.
Step 2: Accept End User License Agreement (EULA)
The Licensee is ultimately responsible for making sure Nodinite products are used according to the End User License Agreement. Make sure you have the assigned formal rights to install and perform modifications to the target environment before you continue installing any Nodinite products.
Review and accept the EULA to proceed.
Step 3: Welcome screen
On successful execution of the MSI file, a Welcome screen is presented.
The installer welcomes you to the setup process.
Click the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Step 4: Custom setup
Select the Components and Location of the installation. Default settings are recommended.
Choose components and installation path as needed.
Click the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Step 5: Service Account Information
Enter the credentials for the Account to run Nodinite Message QueuesMonitoring Agent. Depending on the connection string settings, this account will be used to log on and query the databases being monitored.
Domain: The name of the Domain the Server belongs to. If a local account is being used, use the name of the server or a . (dot) as Domain
User: The name of the account
Password: The password for the account.
Note
The account must have 'Log on as Service Right'
Enter the service account credentials here.
Click the 'Next' button to continue the installation process or the 'Cancel' button to quit the installer.
Insufficient Privileges
Error message when account information does not meet Prerequisites.
This error appears if the account lacks required permissions.
If you get this message, the most common reason is that the account is not allowed to run as a service or is not a local Administrator on the server. Follow the guide How to set Logon as a Service right and click retry. If the problem remains, click cancel and restart. Make sure to enter valid credentials!
Tip
Check the local event log if there are errors (both System and Application)
Step 6 Ready to install
Click next to start the installation.
Step 7 Completed setup
The last step of the installation gives either a success or a premature exit.
Successful installation example
Installation completed successfully.
Failed installation example: A failed installation will render a premature exit.
If installation fails, review the error and retry.
Click the Finish button to Exit and quit the installer.
When the setup has finished, the default text editor will open a text file named the 'README.txt'. The README.txt file holds additional information that you need to add the agent as a Monitoring Agents.
Review the README.txt for next steps.
Step 8: Add Agent as a new Monitoring Agent Configuration
The last installation step is to install the Monitoring Agent as a new Monitoring Agents from within the Web Client using the information provided in the README.txt file from the previous step.
Support
Contact our Support for additional guidance if you fail to resolve the installation problem.
Note
Additional information to aid the troubleshooting may exist in the Windows Event Logs.
Frequently asked questions
Additional solutions to common problems and the FAQ for the Nodinite Message Queueing Monitoring Agent exist in the Troubleshooting user guide.
Next Step
Configuration of the agent
Update
Uninstall
Related Topics
Add or manage a Monitoring Agent Configuration
Monitoring Agents
Prerequisites for Message Queueing Monitoring Agent
Web Client